Add, methode

           

Voegt een lid toe aan een object Collection.

Syntaxis

object.Add item, key, before, after

De syntaxis van de methode Add heeft de volgende objectkwalificatie en benoemde argumenten:

Onderdeel Beschrijving
Object Vereist. Een objectexpressie die gelijkwaardig is aan een object in de lijst Van toepassing op.
item Vereist. Een willekeurige expressie die opgeeft welk lid aan de collectie moet worden toegevoegd.
key Optioneel. Een unieke tekenreeksexpressie die een sleuteltekenreeks opgeeft die in plaats van een positionele index kan worden gebruikt om toegang te krijgen tot een onderdeel van de collectie.
before Optioneel. Een expressie die een relatieve positie in de collectie opgeeft. Het lid dat moet worden toegevoegd, wordt in de collectie geplaatst v≤≤r het lid dat wordt herkend aan het argument before. Als dit een numerieke expressie is, moet before een getal zijn van 1 tot de waarde van de eigenschap Count van de collectie. Als dit een tekenreeksexpressie is, moet before overeenkomen met de waarde voor key die werd opgegeven toen het lid waarnaar wordt verwezen aan de collectie werd toegevoegd. U kunt posities voor before of after opgeven, maar niet voor beide.
after Optioneel. Een expressie die een relatieve positie in de collectie opgeeft. Het onderdeel dat moet worden toegevoegd, wordt in de collectie geplaatst na het onderdeel dat wordt herkend aan het argument after. Als dit een numerieke expressie is, moet after een getal zijn van 1 tot de waarde van de eigenschap Count van de collectie. Als dit een tekenreeksexpressie is, moet after overeenkomen met de key-waarde die werd opgegeven toen het onderdeel waarnaar wordt verwezen, aan de collectie werd toegevoegd. U kunt posities voor before of after opgeven, maar niet voor beide.

Notities

Het argument before of after moet, ongeacht of het een tekenreeks- of numerieke expressie is, altijd naar een bestaand lid van de collectie verwijzen, anders treedt er een fout op.

Er treedt eveneens een fout op als de opgegeven key-waarde de key-waarde voor een bestaand element van de collectie dupliceert.